Skip to content

[Images] Document transformation flows - #30021

Merged
deannalam merged 5 commits into
productionfrom
deanna/flows
May 26, 2026
Merged

[Images] Document transformation flows#30021
deannalam merged 5 commits into
productionfrom
deanna/flows

Conversation

@deannalam

Copy link
Copy Markdown
Contributor

Summary

Adds a new reference page to document transformation flows.

Changes

New pages

  • flows.mdx — covers types of flows, how flows are evaluated, and a step-by-step setup with common parameters

Updated content

  • Rewrote make-responsive-images.mdx to be clearer and more structured
  • Fixed mistake from PR 29892 on default fit behavior
  • Updated index.mdx landing page to add a feature card for flows
  • Fixed minor styling issues
  • Added documentation for new width=auto sub-parameters

@deannalam
deannalam requested a review from a team April 17, 2026 04:52
@deannalam
deannalam requested a review from a team as a code owner April 17, 2026 04:52
@github-actions github-actions Bot added product:images Related to Image Resizing product size/l labels Apr 17, 2026
@github-actions

Copy link
Copy Markdown
Contributor

This PR requires additional review attention because it affects the following areas:

Partials

This PR updates partial files, which are pieces of content used across multiple files in our Render component.

@github-actions

github-actions Bot commented Apr 17, 2026

Copy link
Copy Markdown
Contributor

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/assets/images/ @cloudflare/pm-changelogs, @cloudflare/product-owners
/src/content/docs/images/ @dcpena, @cloudflare/product-owners, @renandincer, @third774
* @cloudflare/product-owners

@github-actions

github-actions Bot commented Apr 17, 2026

Copy link
Copy Markdown
Contributor

Preview URL: https://ff6dba49.preview.developers.cloudflare.com
Preview Branch URL: https://deanna-flows.preview.developers.cloudflare.com

Files with changes (up to 15)

Original Link Updated Link
https://developers.cloudflare.com/images/optimization/make-responsive-images/ https://deanna-flows.preview.developers.cloudflare.com/images/optimization/make-responsive-images/
https://developers.cloudflare.com/images/optimization/transformations/flows/ https://deanna-flows.preview.developers.cloudflare.com/images/optimization/transformations/flows/
https://developers.cloudflare.com/images/ https://deanna-flows.preview.developers.cloudflare.com/images/
https://developers.cloudflare.com/images/optimization/features/ https://deanna-flows.preview.developers.cloudflare.com/images/optimization/features/
https://developers.cloudflare.com/images/optimization/transformations/bindings/ https://deanna-flows.preview.developers.cloudflare.com/images/optimization/transformations/bindings/
https://developers.cloudflare.com/images/optimization/transformations/control-origin-access/ https://deanna-flows.preview.developers.cloudflare.com/images/optimization/transformations/control-origin-access/
https://developers.cloudflare.com/images/optimization/transformations/draw-overlays/ https://deanna-flows.preview.developers.cloudflare.com/images/optimization/transformations/draw-overlays/
https://developers.cloudflare.com/images/optimization/transformations/preserve-content-credentials/ https://deanna-flows.preview.developers.cloudflare.com/images/optimization/transformations/preserve-content-credentials/
https://developers.cloudflare.com/images/optimization/transformations/transform-via-workers/ https://deanna-flows.preview.developers.cloudflare.com/images/optimization/transformations/transform-via-workers/
https://developers.cloudflare.com/images/optimization/transformations/overview/ https://deanna-flows.preview.developers.cloudflare.com/images/optimization/transformations/overview/

@deannalam
deannalam requested a review from dochne April 17, 2026 09:16
Comment thread src/content/docs/images/optimization/transformations/flows.mdx Outdated
Comment thread src/content/docs/images/optimization/transformations/flows.mdx Outdated
Comment thread src/content/docs/images/optimization/transformations/flows.mdx Outdated
Comment thread src/content/docs/images/optimization/transformations/flows.mdx Outdated
@@ -0,0 +1,133 @@
---
pcx_content_type: reference
title: Create transformation flows

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
title: Create transformation flows
title: Create transformation flows
description: Define automated rules to optimize remote images without writing any code or changing your existing URLs.

Comment thread src/content/docs/images/optimization/transformations/flows.mdx
Comment thread src/content/docs/images/optimization/transformations/flows.mdx Outdated
Comment thread src/content/docs/images/optimization/transformations/flows.mdx Outdated
Comment thread src/content/docs/images/optimization/make-responsive-images.mdx Outdated
Comment thread src/content/docs/images/optimization/make-responsive-images.mdx Outdated
Comment thread src/content/docs/images/optimization/make-responsive-images.mdx Outdated
Comment thread src/content/docs/images/optimization/make-responsive-images.mdx Outdated
---
import { Description, Render } from "~/components";

<Description>

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We typically use the Description component on the main landing page overviews. I would combine this sentence with line 13 and remove the use of this component.

@github-actions

github-actions Bot commented May 9, 2026

Copy link
Copy Markdown
Contributor

Hey there, we've marked this pull request as stale because there's no recent activity on it. This label helps us identify PRs that might need updates (or to be closed out by our team if no longer relevant).

@github-actions github-actions Bot added the stale label May 9, 2026
@deannalam
deannalam requested a review from a team as a code owner May 21, 2026 19:03
Co-authored-by: Denise Peña <75506267+dcpena@users.noreply.github.com>

@mikenomitch mikenomitch left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approving to unblock (as team has reviewed)

@deannalam
deannalam merged commit 02d84f2 into production May 26, 2026
19 checks passed
@deannalam
deannalam deleted the deanna/flows branch May 26, 2026 19:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

product:images Related to Image Resizing product size/l

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants